***************************************************
  README.TXT for the Linux USB Touch Panel Driver
  released date: 2006.7.26
***************************************************


============
Introduction
============
This driver is designed for X Window system of Linux.


==============
Supported List
==============
The supported distributions are listed bellow:

   Redhat 8.0, Redhat 9.0,
   Fedora Core 1, Fedora Core 2, Fedora Core 3, Fedora Core 4, Fedora Core 5
   SUSE 9.3 and SUSE 10.0.


=========
File List
=========
All files in this package are listed bellow:

   readme.txt        This file which it described what distributions supported,
                     what this package contain and how to install this package
                     by automatically or manually.
   auto_install      A shell script which automatically install ETouch driver related.
   auto_uninstall    A shell script which automatically remove ETouch driver related.
   obj/ETouch_drv.o  The object file of the ETouch driver.
   obj/tscpl         A calibration tool which it makes the touch point of panel
                     matched with the cursor on screen.
   obj/liftoff       This tool is used to enable the lift-off mode.
                     In the lift-off mode, the click is activated when touch is
                     lifted away from the touch screen. However, it is impossible
                     to drag or draw in this mode.
   obj/swap          This tool is used to swap touch or lift-off definition which
                     is between left and right mouse buttons.


==================
Installation guide
==================
Please follow automatic installation procedures for the supported distributions
as above. If the distribution is not listed in supported list, you can do manual
installation steps. Please make sure your Linux & X Window System is working
properly before the installation. Make sure login as root to do the installation
and calibration. Open a terminal session to do the following automatic or manual
installation steps.

1. Automatic Installation Procedures

   1.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

       Copy all related files from CD to "/home/touch_CD" directory

   1.1 Change directory to /home/touch_CD and execute auto_install shell script
       to install the driver.

          cd /home/touch_CD

          ./auto_install

   1.2 After finishing the installation, you will be asked to reboot the computer.

   1.3 If you choose to reboot the computer, please plug in the touch controller
       to USB port prior rebooting.

   1.4 After system reboot complete, you have to execute "Calibration" to do the
       calibration for the touch panel.

          cd /usr/local/bin

          ./Calibration

       When you start the calibration program, you will see a circle with cross
       inside displayed at the lower left corner on the screen. You have to touch
       it by your fingertip or the tip of pen. The program will display additional
       two circles with cross inside, please touch them as well.

   1.5 There are three tools "Calibration", "Lift-off" and "Swap" will be put
       into the /usr/local/bin directory.

       The tool "Calibration" which it makes the touch point of panel matched
       with the cursor on screen.

       The tool "Lift-off" which it enables the lift-off mode. In the lift-off
       mode, the click is activated when touch is lifted away from the touch
       screen. However, it is impossible to drag or draw in this mode.

       The tool "Swap" is used to swap touch or lift-off definition which is
       between left and right mouse buttons.

   1.6 In order to access these tools easily, the auto_install shell script
       will create icons onto your Desktop.

2. Manual Installation Steps

   2.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

   2.1 Mount the CD and copy all related files to "/home/touch_CD" directory

   2.2 Please create /etc/etandt directory for saving some initial files of
       the touch screen application.

          mkdir /etc/etandt

   2.3 In order to ensure you can return to original configuration, please make
       a copy of configuration file, depend on what operating system you are
       running. The /etc/X11/XF86Config is used by system if you are running
       Redhat 8.0, Redhat 9.0, and Fedora Core 1. The /etc/X11/xorg.conf is
       used by system if you are running Fedora Core 2, Fedora Core 3,
       Fedora Core 4, Fedora Core 5, SUSE 9.3 and SUSE 10.0. Otherwise, you
       have to find out the configuration file which is used by operating
       system you are running.

          cp /etc/X11/XF86Config /etc/X11/XF86Config.bak
       or
          cp /etc/X11/xorg.conf  /etc/X11/xorg.conf.bak

   2.4 Use editor, for example the vi, to add strings to /etc/X11/XF86Config or
       /etc/X11/xorg.conf.

       2.4.1 Find "ServerLayout" section, add the following entry:

             Section "ServerLayout"
             Inputdevice "ETouch" "SendCoreEvents"
             EndSection

       2.4.2 Find the path of hiddev0 description file to add the following entry:

             For example, in Redhat 8.0, Redhat 9.0, Fedora Core 1, Fedora Core 2 and SUSE 9.3:

                Section "InputDevice"
                Identifier "ETouch"
                Driver "ETouch"
                Option "Device" "/dev/usb/hiddev0"
                EndSection

             For example, in Fedora Core 3, Fedora Core 4, Fedora Core 5 and SUSE 10.0:

                Section "InputDevice"
                Identifier "ETouch"
                Driver "ETouch"
                Option "Device" "/dev/hiddev0"
                EndSection

       2.4.4 Save changes to the configuration file and exit the editor.

   2.5 Copy the ETouch_drv.o file from /home/touch_CD to the directory that it
       stores the module object files of X server. You can refer to the X server
       log file.

       For example, in Fedora Core 5:

          cp /home/touch_CD/obj/ETouch_drv.o /usr/lib/xorg/modules/input

       For example, in Fedora Core 1:

          cp /home/touch_CD/obj/ETouch_drv.o /usr/X11R6/lib/modules/input

   2.6 Copy three tools "tscpl", "liftoff" and "swap" to the directory /usr/bin.
       Their functionality was described in file list. In order to access them
       easily, you can copy them to your Desktop.

   2.7 Make sure to plug the controller into USB port before reboot the computer.

   2.8 When first time start X Window, the touch controller may be not
       accurately matched to the screen, please execute /usr/bin/tscpl
       to calibrate the touch screen:

          cd /usr/bin

          ./tscpl

   2.9 Please don't use virtual desktop environment with touch screen, due to
       it will not accurately for calibration.


====
Note
====
1. Please pay attention with Uppercase and Lowercase on above command examples,
   Linux commands are case-sensitive.

2. If you still have problem with the driver installation, please type

      startx &> startx.out

   This will create startx.out with some debug information. Please send back
   the start.out log to us for trouble-shooting.
